home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet internetowy / Czytniki RSS / RSS Bandit 1.3.0.42 / RssBandit Installer.msi / _172FF5180BC61D3C6D240F14338A23AA / _309E249E3649467380AA2C3362AFFBAE < prev    next >
Text File  |  2004-12-12  |  7KB  |  117 lines
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html>
  3. <head>
  4.     <title>RSS Bandit Templates Readme</title>
  5.     <style>
  6.           body, td, li        { font-family:Verdana;Arial; font-size:11pt;font-weight:normal;}
  7.           h1,h2,h3,h4,h5 { font-family:Verdana;Arial; }
  8.             code { font-size:12pt; }
  9.             p  { font-family:Verdana,Arial;font-size:11pt; font-weight:normal; margin:5pt;padding:5pt;  }
  10.             a:link      { color:#336699;text-decoration:none; }
  11.             a:visited   { color:#336699;text-decoration:none; }
  12.             a:hover        { color:#99CCFF;text-decoration:none; }
  13.         </style>
  14. </head>
  15. <body>
  16. <h2>RSS Bandit Templates Readme<h2>
  17. <p style="font-size:xx-small;">Last modified Feb. 03, 2004<br />
  18. <a href="http://www.rssbandit.org">www.rssbandit.org</a></p>
  19. <h2 id="preface">Preface</h2>
  20. <p>This folder contains the RSS Bandit Item formatting samples.
  21. If you start experimenting with these, ensure you use your own: copy/rename
  22. the interesting one, and change it to apply your needs.</p>
  23.  
  24. <h3 id="toc">Table of contents</h3>
  25. <ul>
  26. <li><a href="#preface">Preface</a></li>
  27. <li><a href="#basics">Basics</a></li>
  28. <li><a href="#elements">Elements</a></li>
  29. <li><a href="#bestpractice">Best practice</a></li>
  30. <li><a href="#getinvolved">Get involved</a></li>
  31. </ul>
  32. <h3 id="basics">Basics</h3>
  33. <p>You should be familiar with XSLT to be able to get it work.
  34. The input of each XSLT stylesheet is a XML document fragment describing an RSS item.
  35. The root element will be a <code>newspaper</code> element which will have contain one or more <a href="http://blogs.law.harvard.edu/tech/rss#whatIsRss">
  36. RSS 2.0 <code>channel</code> elements</a> as children. 
  37. The subelements of the <code>channel</code> element depend on the information 
  38. provided by a particular RSS feed. This format is identical to that emitted by <a href="http://www.bradsoft.com/feeddemon/help/1.0/newspapers/index.asp">FeedDemon's Newspaper Styles</a> which means all FeedDemon styles are valid RSS Bandit styles and vice versa. 
  39. </p>
  40. <h3 id="elements">Elements</h3>
  41. <p>The <a href="http://blogs.law.harvard.edu/tech/rss#requiredChannelElements">required base elements</a>
  42.  of the channel element are provided for custom formatting.
  43. </p>
  44. <p>
  45. Besides the <a href="http://blogs.law.harvard.edu/tech/rss#hrelementsOfLtitemgt">subelements of the 
  46. <code>item</code> element</a> specified in the RSS 2.0 spec there may also be elements from other 
  47. namespaces which correspond to various RSS 2.0 modules. Brief descriptions of such modules and elements
  48. are provided in the table below. 
  49. <br /><br />
  50. <table border="0">
  51. <tr><td><b>Module Name</b></td><td><b>Description</b></td></tr>
  52. <tr><td><a href="http://web.resource.org/rss/1.0/modules/dc/">Dublin Core</a></td>
  53. <td>The Dublin Core Metadata Element Set provides some standard metadata elements for describing 
  54. published content on the web.</td></tr>
  55. <tr><td><a href="http://web.resource.org/rss/1.0/modules/content/">Content</a></td>
  56. <td>A module for the actual content of websites, in multiple formats. The most commonly used 
  57. element from this module is <code>content:encoded</code></td></tr>
  58. <tr><td><a href="http://web.resource.org/rss/1.0/modules/slash/">Slash</a></td><td>
  59. The Slash RSS 1.0 module augments the RSS core and Dublin Core module's metadata with channel and item-level elements specific to <a href="http://slashcode.com/">SlashCode</a>-based sites</td></tr>
  60. <tr><td><a href="http://wellformedweb.org/story/9#autorss">CommentAPI</a></td>
  61. <td>Describes the <code>wfw:comment</code> element which is used to provide the location of the 
  62. CommentAPI endpoint to aggregator software.</td></tr>
  63. <tr><td><a href="http://www.intertwingly.net/blog/1299.html">XHTML in RSS 2.0</a></td>
  64. <td>Specifies the use of the <code>xhtml:body</code> element to provide content in an RSS feed.</td></tr>
  65. <tr><td><a href="http://matt.blogs.it/specs/ENT/1.0/">Easy News Topics</a></td>
  66. <td>ENT is provides a mechanism for describing how topic information can be introduced into an RSS 2.0 news feed</td></tr>
  67. <tr><td></td><td></td></tr>
  68. </table>
  69. </p>
  70.  
  71. <h3 id="bestpractice">Best practice</h3>
  72. <p>At first you have to enable the usage of a custom formatter within the options dialog: select the menu File|Options...
  73. and then the tab named "Display". Ensure the checkbox "Use a custom formatter" is checked. Then play with the existing formatter 
  74. stylesheets.</p>
  75. <!-- <p>If you are familar with the differences, or you have your own ideas born go back to the options dialog and check on the option "Formatter design mode".
  76. This option is valid as long the progam is running. The next time you start Bandit, it is checked off again.
  77. Now you can start editing the selected stylesheet with you favourite text editor. Each change will be immediatly active
  78. if you select a feed's rss item to display. Errors are reported by a message box and the display switches back to a working internal 
  79. simple formatting temporary. Next time you have corrected the error, your stylesheet is used again. 
  80. </p>
  81. <p>Additionally the input used by your stylesheet is saved each time you select an rss item to display to your 
  82. system temporary folder as a file named "RSSItem.xml" for your reference.
  83. </p> -->
  84. <p>Your stylesheet should produce valid (X)HTML. If you want to use CSS for visual effects, ensure to use it in
  85. the embedded form to keep it with your formatting templates. Do not forget to insert an HTML <b><code>base</code> element</b> 
  86. within the HTML HEAD section to get relative links of images resolved by the browser control! The existing stylesheets can be used as examples as to how to generate this correctly for the different views. </p>
  87. <p>There is support to split the css stylesheet to a separate file. If your formatter stylesheet
  88. want to use that, you have to add these two prameters on the root level (child of <xsl:stylesheet>):
  89. <xmp>
  90.   <xsl:param name='AppStartupPath'/>
  91.   <xsl:param name='AppUserDataPath'/>
  92. </xmp>
  93. <p>
  94. They are filled by RssBandit to reflect:
  95. <ul><li>AppStartupPath: the current path to the executable RssBandit.exe (C:\Program Files\RssBandit)
  96. <li>AppUserDataPath: the path to the Application Data folder <br />
  97.     (usually C:\Documents and Settings\<username>\Application Data\RssBandit)
  98. </ul>
  99. <p>
  100. Now you can code a line like this:
  101. <xmp>
  102. <link rel="stylesheet" type="text/css" href="{$AppStartupPath}/templates/my-new.css" />
  103. </xmp>
  104. <p>
  105. pointing to a css file located at C:\Program Files\RssBandit\templates.
  106. </p>
  107.  
  108. <h3 id="getinvolved">Get involved</h3>
  109. <p>Feel free to join the Developer community at <a href="http://dev.rssbandit.org">dev.rssbandit.org</a> 
  110. by providing patches, suggestions or error reporting! 
  111. <br />
  112. Rss Bandit users may visit our forum at <a href="http://www.rssbandit.org/forum/">www.rssbandit.org/forum</a>.
  113. </p>
  114.  
  115. </body>
  116. </html>
  117.